---
displayed_sidebar: "Chinese"
---

# tanh

## 功能

计算输入数值的双曲正切值。

该函数从 3.0 版本开始支持。

## 语法

```Haskell
DOUBLE tanh(DOUBLE arg)
```

### 参数说明

`arg`：指定一个数值。该函数在计算输入数值的双曲正切值之前，会先把数值转换为 DOUBLE 类型的值。

## 返回值说明

返回一个 DOUBLE 类型的值。

## 使用说明

如果入参指定为非数值，则返回 `NULL`。

## 示例

```Plain
mysql> select tanh(-1);
+---------------------+
| tanh(-1)            |
+---------------------+
| -0.7615941559557649 |
+---------------------+

mysql> select tanh(0);
+---------+
| tanh(0) |
+---------+
|       0 |
+---------+

mysql> select tanh(1);
+--------------------+
| tanh(1)            |
+--------------------+
| 0.7615941559557649 |
+--------------------+

mysql> select tanh("");
+----------+
| tanh('') |
+----------+
|     NULL |
+----------+
```

## 关键字

TANH
